## Chapter 7: Administering Telephone Options

## Administering Options for the 9600 Series IP Telephones

This chapter explains how to change parameters by means of the DHCP or HTTP servers. In all cases, you are setting a system parameter in the telephone to a desired value. Table 7 lists:

- the parameter names,
- their default values,
- the valid ranges for those values, and
- a description of each one.

For DHCP, the DHCP Option sets these parameters to the desired values as discussed in DHCP and File Servers. For HTTP, the parameters in Table 7 are set to desired values in the script file. For more information, see Contents of the Settings File. When using a media server, see Table 6: Media Server Field Names & Corresponding Script File Parameter Names for information on parameters set by the media server application.

Avaya recommends that you administer options on the 9600 Series IP Telephones using script files. Some DHCP applications have limits on the amount of user-specified information. The administration required can exceed those limits for the more full-featured telephone models.

You might choose to completely disable the capability to enter or change option settings from the dialpad. You can set the system value, PROCPSWD, as part of standard DHCP/HTTP administration. If PROCPSWD is non-null and consists of 1 to 7 digits, the user cannot invoke any “dialpad options” without first pressing Mute or Hold and entering the PROCPSWD value. For more information on dialpad options, see the Avaya one-X Deskphone Edition for 9600 IP Telephones Installation and Maintenance Guide.

CAUTION: PROCPSWD is likely stored on the server “in the clear” and is sent to the telephone in the clear. Therefore, do not consider PROCPSWD as a high-security technique to inhibit a sophisticated user from obtaining access to local procedures.
Administering this password can limit access to all local procedures, including
V I E W. VIEW is a read-only option that allows review of the current telephone settings.

Table 7: 9600 Series IP Telephone Customizable System Parameters
Parameter Name | Default Value | Description and Value Range
--- | --- | ---
AGCHAND | 1 | Automatic Gain Control status for handset (0=disabled, 1=enabled).
AGCHEAD | 1 | Automatic Gain Control status for headset (0=disabled, 1=enabled).
AGCSPKR | 1 | Automatic Gain Control status for Speaker (0=disabled, 1=enabled).
APPNAME | " " (Null) | Primary application image file name, as provided in the 9600upgrade.txt file.
APPSTAT | 1 | Controls whether specific applications are enabled, restricted, or disabled. Values are: 1=all applications enabled, 2=Speed Dial (Contacts) changes and Call Log disabled and Redial last number only, 3=Speed Dial (Contacts) changes disabled, 0=Speed Dial (Contacts) changes, Call Log, and Redial disabled.
AUTH | 0 | Script file authentication value (0=HTTP is acceptable, 1=HTTPS is required).
BAKLIGHTOFF | 120 | Number of minutes without display activity to wait before turning off the backlight. Values: 0-999, no spaces and no null value. A value of 0 means the backlight never turns off.
BRURI | " " (Null) | URL used for backup and retrieval of user data. Specify HTTP server and directory path to backup file. Do not specify backup file name. Value: 0-255 ASCII characters. Null is a valid value and spaces are allowed.
CNAPORT | 50002 | Avaya Converged Network Analyzer (CNA) server registration transport-layer port number (0-65535).
CNASRVR | “ ” (Null) | Text string containing the IP addresses of one or more Avaya Converged Network Analyzer (CNA) servers to be used for registration. Format is dotted decimal or DNS format, separated by commas, with no spaces (0-255 ASCII characters, including commas).
CTIUDPPORT | 49721 | Computer Telephony Interface Port. UDP port value for reception of broadcast CTI discovery messages, from “49714” to “49721.” Null is not a valid value and spaces not allowed.
DHCPSTD | 0 | DHCP Standard lease violation flag. Indicates whether to keep the IP address if there is no response to lease renewal. If set to “1” (No) the telephone strictly follows the DHCP standard with respect to giving up IP addresses when the DHCP lease expires. If set to “0” (Yes) the telephone continues using the IP address until it detects reset or a conflict (see DHCP Generic Setup).
DNSSRVR | 0.0.0.0 | Text string containing the IP address of zero or more DNS servers, in dotted-decimal format, separated by commas with no intervening spaces (0-255 ASCII characters, including commas).
DOMAIN | " " (Null) | Text string containing the domain name to be used when DNS names in system values are resolved into IP addresses. Valid values are 0-255 ASCII characters. If Null, no spaces allowed.
DOT1X | 0 | 802.1X Supplicant operation mode. Valid values are: 0=With PAE pass-through, 1=with PAE pass-through and proxy Logoff, 2=without PAE pass-through or proxy Logoff.
ENHDIALSTAT | 1 | Enhanced Dialing Status. If set to “1” the Enhanced Local Dialing feature is turned on for all associated applications. If set to “0” the feature is turned off.
HTTPDIR | " " (Null) | HTTP server directory path. The path name prepended to all file names used in HTTP and HTTPS get operations during initialization. Value: 0-127 ASCII characters, no spaces. Null is a valid value. Leading or trailing slashes are not required.
HTTPSRVR | " " (Null) | Text list of HTTP server addresses in dotted decimal or DNS format, separated by commas (0-255 ASCII characters, including commas).
ICMPDU | 0 | Controls whether ICMP Destination Unreachable messages will be processed. Values are: 0=No, 1=Send limited Port Unreachable messages, 2=Send Protocol and Port Unreachable messages.
ICMPRED | 0 | Controls whether ICMP Redirect messages will be processed. Values are: 0=No, 1=Yes.
L2Q | 0 | Controls whether Layer 2 frames have IEEE 802.1Q tags (0=auto, 1=enabled, 2=disabled).
L2QVLAN | 0 | 802.1Q VLAN Identifier (0 to 4094). Null (" ") is not a valid value and the value cannot contain spaces. VLAN identifier used by IP telephones. Set this parameter only when IP telephones are to use a VLAN that is separate from the default data VLAN. If the VLAN identifier is to be configured via H.323 signaling based on Avaya Communication Manager administration forms, it should not be set here.
LOGLOCAL | 0 | Event Log Severity Level (one 0-8 ASCII numeric digit). Controls the level of events logged in the endptRecentLog and endptResetLog objects in the SNMP MIB. Events with the selected level and with a higher severity level will be logged. Valid values are: 0=Disabled, 1=emergencies, 2=alerts, 3=critical, 4=errors, 5=warnings, 6=notices, 7=information, 8=debug.
LOGSRVR | " " (Null) | Voice Monitoring Manager (VMM) Server Address. Zero or one IP address in dotted-decimal format or DNS Name format (0-15 ASCII characters).
MCIPADD | 0.0.0.0 | Call Server Address. Zero or more Avaya Communication Manager server IP addresses. Format is dotted-decimal or DNS name format, separated by commas without intervening spaces (0-255 ASCII characters, including commas). Null is a valid value.
MSGNUM | " " (Null) | Voice mail telephone number. Specifies the number to be dialed automatically when the telephone user presses the Message button. Value: 0-30 ASCII dialable characters (0-9, * and #) and no spaces. Null is a valid value.
OPSTAT | 111 | Options status flag(s) (1 or 3 ASCII numeric digits) indicate which options are user-selectable. The default of 111 grants access to all options and related applications. Single digit valid values are: 1=user can access all options, including Logout, 2= user can access only view-oriented applications. Three-digit valid values are a concatenation of binary values, in the form abc, where each letter represents a 0 (disabled/off) or 1 (enabled/on), interpreted as: a = base settings for all user options and related applications, except as noted in b or c. b = setting for view-oriented applications (for example, the Network Information application), as applicable. c = setting for Logout application, if applicable. The binary "0" does not allow an end user to see or invoke options and related applications. The binary "1" allows full display and access to all options and related applications.
PHNCC | 1 | Telephone country code. The administered international country code for the location by the algorithm that dials calls from the incoming Call Log or from Web pages. Range: 1-3 digits, from “1” to “999.”
PHNDPLENGTH | 5 | Internal extension telephone number length. Specifies the number of digits associated with internal extension numbers by the algorithm that dials calls from the incoming Call Log or from Web pages. Range: 1 or 2 digits, from “3” to “10.”
PHNIC | 011 | Telephone international access code. The maximum number of digits, if any, dialed to access public network international trunks by the algorithm that dials calls from the incoming Call Log or from Web pages. Range: 0-4 digits.
PHNLD | 1 | Telephone long distance access code. The digit, if any, dialed to access public network long distance trunks by the algorithm that dials calls from the incoming Call Log or from Web pages. Range: 1 digit or " " (Null).
PHNLDLENGTH | 10 | Length of national telephone number. The number of digits in the longest possible national telephone number by the algorithm that dials calls from the incoming Call Log or from Web pages. Range: 1 or 2 digits, from “3” to “10.” Range: 1 or 2 ASCII numeric characters, from “5” to “15.”
PHNOL | 9 | Outside line access code. The character(s) dialed, including # and *, if any, to access public network local trunks by the algorithm that dials calls from the incoming Call Log or from Web pages. Range: 0-2 dialable characters, including " " (Null).
PHY1STAT | 1 | Ethernet line interface setting (1=auto-negotiate, 2=10Mbps half-duplex, 3=10Mbps full-duplex, 4=100Mbps half-duplex, 5=100Mbps full-duplex).
PHY2PRIO | 0 | Layer 2 priority value for frames received on or forwarded to the secondary Ethernet interface. Set this parameter only when VLAN separation is "1" (enabled). Values are from 0-7 and correspond to the drop-down menu selection.
PHY2STAT | 1 | Secondary Ethernet interface setting (0=Secondary Ethernet interface off/disabled, 1=auto-negotiate, 2=10Mbps half-duplex, 3=10Mbps full-duplex, 4=100Mbps half-duplex, 5=100Mbps full-duplex).
PHY2VLAN | 0 | VLAN identifier used by frames received on or forwarded to the secondary Ethernet interface. Set this parameter only when VLAN separation is "1" (enabled). Value is 1-4 ASCII numeric digits from “0” to “4094.” Null is not a valid value, nor can the value contain spaces.
PROCPSWD | " " (Null) | Text string containing the local (dialpad) procedure password (Null or 1-7 ASCII digits). If set, password must be entered immediately after Mute is pressed and before entry of a procedure command (for example, VIEW). Intended to facilitate restricted access to local procedures even when command sequences are known. Password is viewable, not hidden.
PROCSTAT | 0 | Local (dialpad) Administrative procedures status (0=Local procedures enabled, 1=all Administrative Options are disabled).
REREGISTER | 20 | Registration timer in minutes. Controls an H.323 protocol timer that should only be changed under very special circumstances by someone who fully understands the system operation impact. Value is 1-120.
RTCPMON | " " (Null) | Text string containing the 4-octet IP address of the RTCP monitor currently in use, in dotted decimal or DNS Name format (0-15 ASCII characters, no spaces).
SCREENSAVERON | 60 | Number of idle time minutes after which the screen saver is turned on. Valid values are 1-3 ASCII numeric digits, 0-999.
SNMPADD | " " (Null) | Text string containing zero or more allowable source IP addresses for SNMP queries, in dotted decimal or DNS format, separated by commas, with up to 255 total ASCII characters including commas.
SNMPSTRING | " " (Null) | Text string containing the SNMP community name string (up to 32 ASCII characters, no spaces).
STATIC | 0 | Static programming override flag. If set to “0” static programming never overrides call server (DHCP) or call server administered data. If set to “1” static programming overrides only file server administered data. If set to “2” static programming overrides only call server administered data. If set to “3” static programming overrides both file server- and call server-administered data. Allows a call server IP address that has been manually programmed into a telephone to override any value received via DHCP or via this configuration file. A manually programmed IP address will only be used if it is not 0.0.0.0, so this parameter may be used to allow only specific telephones to use a different value than otherwise provided by this configuration file. If STATIC is to be used to select a manual override of file server IP address(es), STATIC must be set via DHCP, not via this configuration file.
SUBSCRIBELIST | " " (Null) | One or more Push application server subscription URLs, separated by commas without any intervening spaces (0-255 ASCII characters, including commas).
TPSLIST | " " (Null) | One or more trusted domain/path strings, separated by commas without any intervening spaces (0-255 ASCII characters, including commas). A URL pushed to a telephone must contain one of these strings if it is to be used to obtain content to be rendered by the telephone.
UNNAMEDSTAT | 1 | Unnamed Registration Status. Specifies whether unnamed registration is initiated if the user fails to enter a value at the Extension: prompt or Login screen. Unnamed registration provides the telephone with a TTI-level service, enabling a user, for example, to dial emergency services like 911. Value 1=Yes, 0=No.
VLANSEP | 1 | VLAN separation. Controls whether frames to/from the secondary Ethernet interface receive IEEE 802.1Q tagging treatment. The tagging treatment enables frames to be forwarded based on their tags in a manner separate from telephone frames. If tags are not changed, no tag-based forwarding is employed. Values are: 1=On/Enabled, 2= Off/Disabled. This parameter is used with several related parameters. For more information, see VLAN Separation.
VLANTEST | 60 | Number of seconds to wait for a DHCPOFFER when using a non-zero VLAN ID (1-3 ASCII digits, from “0” to “999”).
WMLEXCEPT | " " (Null) | One or more HTTP proxy server exception domains that do not require the use of the proxy server (0-127 ASCII characters, including commas, without any intervening spaces). Set this parameter only if a proxy server is used and if there are exception domains.
WMLHOME | " " (Null) | URL that specifies the home page for Web browsers that use WML. Zero or one URL (0-255 ASCII characters, including spaces, if any). If Null, the Web application will not be displayed.
WMLIDLETIME | 10 | Idle time before displaying Web page. Number of minutes without activity to wait before displaying the idle Web page. Value: 1-999 with no spaces. Null is not a valid value.
WMLIDLEURI | " " (Null) | Idle time Web page URI. URI that specifies the Web page the browser displays after an idle interval. Value: Zero or one URI (0-255 ASCII characters, no spaces). Null is valid but if Null, no page displays.
WMLPORT | 8000 | TCP port number for the HTTP proxy server, if applicable (1-5 ASCII numeric characters from “0” to “65535.” Null is not a valid value.
WMLPROXY | " " (Null) | One HTTP proxy server IP address in dotted decimal or DNS Name format (0-255 ASCII characters). Set this parameter only if Web pages requiring a proxy server will be supported.

NOTE: Table 7 applies to all 9600 Series IP Telephones. Certain 9600 IP Telephones might have additional, optional information that you can administer. For more information, see Chapter 8: Administering Applications and Options.